LEADTOOLS Image Processing (Leadtools.ImageProcessing.Color assembly) Send comments on this topic. | Back to Introduction - All Topics | Help Version 17.0.3.29
ColorReplaceCommand Constructor(ColorReplaceCommandColor[],Int32,Int32,Int32)
See Also  Example



colors
An array of ColorReplaceCommandColor classes that provides information about the replacement color used by this class.
hue
Angular amount to change the hue, in hundredths of degrees. Valid values range from -18000 to 18000. This value is divided internally by 100.
saturation
Amount to change saturation, in tenths of a percent. Valid values range from -1000 to 1000. This value is divided internally by 10. Negative values decrease the saturation of colors. Positive values increase the saturation. The saturation level is increased or decreased by a percentage of its present saturation level. For example, an increase of 20 of the current saturation level "L" will raise the new saturation level "L1" to a value L = 0.20 * L. Likewise, increasing the saturation level 100 doubles the saturation level (L1 = L + 1.0 * L). Decreasing the saturation level 100 will set the new saturation level to 0. The saturation is set to 1000 (maximum value) if the new value exceeds 1000).
brightness
Amount to change the brightness, in tenths of a percent. Valid values range from -1000 to 1000. This value is divided internally by 10. Positive values increase (or lighten) the brightness of the image. Negative values decrease (or darken) the brightness of the image.
Initializes a new ColorReplaceCommandclass object with explicit parameters. Supported in Silverlight, Windows Phone 7

Syntax

Visual Basic (Declaration) 
Public Function New( _
   ByVal colors() As ColorReplaceCommandColor, _
   ByVal hue As Integer, _
   ByVal saturation As Integer, _
   ByVal brightness As Integer _
)
Visual Basic (Usage)Copy Code
Dim colors() As ColorReplaceCommandColor
Dim hue As Integer
Dim saturation As Integer
Dim brightness As Integer
 
Dim instance As New ColorReplaceCommand(colors, hue, saturation, brightness)
C# 
public ColorReplaceCommand( 
   ColorReplaceCommandColor[] colors,
   int hue,
   int saturation,
   int brightness
)
C++/CLI 
public:
ColorReplaceCommand( 
   array<ColorReplaceCommandColor^>^ colors,
   int hue,
   int saturation,
   int brightness
)

Parameters

colors
An array of ColorReplaceCommandColor classes that provides information about the replacement color used by this class.
hue
Angular amount to change the hue, in hundredths of degrees. Valid values range from -18000 to 18000. This value is divided internally by 100.
saturation
Amount to change saturation, in tenths of a percent. Valid values range from -1000 to 1000. This value is divided internally by 10. Negative values decrease the saturation of colors. Positive values increase the saturation. The saturation level is increased or decreased by a percentage of its present saturation level. For example, an increase of 20 of the current saturation level "L" will raise the new saturation level "L1" to a value L = 0.20 * L. Likewise, increasing the saturation level 100 doubles the saturation level (L1 = L + 1.0 * L). Decreasing the saturation level 100 will set the new saturation level to 0. The saturation is set to 1000 (maximum value) if the new value exceeds 1000).
brightness
Amount to change the brightness, in tenths of a percent. Valid values range from -1000 to 1000. This value is divided internally by 10. Positive values increase (or lighten) the brightness of the image. Negative values decrease (or darken) the brightness of the image.

Example

Run the ColorReplaceCommand on an image to change the red color by rotating its hue 90 degree.

Visual BasicCopy Code
Public Sub ColorReplaceConstructorExample()
   Dim codecs As New RasterCodecs()
   codecs.ThrowExceptionsOnInvalidImages = True

   Dim leadImage As RasterImage = codecs.Load(Path.Combine(LEAD_VARS.ImagesDir, "Master.jpg"))

   ' Prepare the command
   Dim Data() As ColorReplaceCommandColor
   ReDim Data(0)
   Data(0) = New ColorReplaceCommandColor(New RasterColor(200, 0, 35), 300)
   Dim command As ColorReplaceCommand = New ColorReplaceCommand(Data, 9000, 0, 0)
   command.Run(leadImage)
   codecs.Save(leadImage, Path.Combine(LEAD_VARS.ImagesDir, "Result.jpg"), RasterImageFormat.Jpeg, 24)

End Sub

Public NotInheritable Class LEAD_VARS
   Public Const ImagesDir As String = "C:\Users\Public\Documents\LEADTOOLS Images"
End Class
C#Copy Code
public void ColorReplaceConstructorExample()
   {
      // Load an image
      RasterCodecs codecs = new RasterCodecs();
      codecs.ThrowExceptionsOnInvalidImages = true;

      RasterImage image = codecs.Load(Path.Combine(LEAD_VARS.ImagesDir, "Master.jpg"));

      // Prepare the command
      ColorReplaceCommandColor[] data = new ColorReplaceCommandColor[1];
      data[0] = new ColorReplaceCommandColor(new RasterColor(200, 0, 35), 100);
      ColorReplaceCommand command = new ColorReplaceCommand(data, 9000, 0, 0);
      command.Run(image);
      codecs.Save(image, Path.Combine(LEAD_VARS.ImagesDir, "Result.jpg"), RasterImageFormat.Jpeg, 24);

   }

static class LEAD_VARS
{
   public const string ImagesDir = @"C:\Users\Public\Documents\LEADTOOLS Images";
}
SilverlightCSharpCopy Code
public void ColorReplaceConstructorExample(RasterImage image, Stream outStream)
{
   // Prepare the command
   ColorReplaceCommandColor[] data = new ColorReplaceCommandColor[1];
   data[0] = new ColorReplaceCommandColor(new RasterColor(200, 0, 35), 100);
   ColorReplaceCommand command = new ColorReplaceCommand(data, 9000, 0, 0);
   command.Run(image);
   // Save result image
   RasterCodecs codecs = new RasterCodecs();
   codecs.Save(image, outStream, RasterImageFormat.Jpeg, 24);
   image.Dispose();
}
SilverlightVBCopy Code
Public Sub ColorReplaceConstructorExample(ByVal image As RasterImage, ByVal outStream As Stream)
   ' Prepare the command
   Dim data As ColorReplaceCommandColor() = New ColorReplaceCommandColor(0){}
   data(0) = New ColorReplaceCommandColor(New RasterColor(200, 0, 35), 100)
   Dim command As ColorReplaceCommand = New ColorReplaceCommand(data, 9000, 0, 0)
   command.Run(image)
   ' Save result image
   Dim codecs As RasterCodecs = New RasterCodecs()
   codecs.Save(image, outStream, RasterImageFormat.Jpeg, 24)
   image.Dispose()
End Sub

Requirements

Target Platforms: Silverlight, Windows XP, Windows Server 2003 family, Windows Server 2008 family, Windows Vista, Windows 7, MAC OS/X (Intel Only)

See Also